home *** CD-ROM | disk | FTP | other *** search
/ Best Tools for JAVA / Best Tools for JAVA.iso / JAVA_ALL / RMI_OS / RMI-PREB / DOC / RMI / README-S.TXT < prev    next >
Encoding:
Text File  |  1996-11-08  |  3.6 KB  |  102 lines
  1.         Installing the RMI package on a Solaris system
  2.         ==============================================
  3.  
  4.     *******************************************************************
  5.     ***                                                             ***
  6.     *** Remember: to run this release, you need to have JDK 1.0.2.  ***
  7.     ***                     Earlier releases will fail.             ***
  8.     ***                                                             ***
  9.     *******************************************************************
  10.  
  11. When you install the RMI package, you will have to choose a place for
  12. it to live on your system.  If you have the necessary permissions, you
  13. can install it as an overlay on top of your existing JDK installation.
  14.  
  15. The RMI release add files and directories to the JDK and replaces a few
  16. existing JDK files in order for prebeta RMI to be as compatible as
  17. possible with JDK1.1 RMI. Here is a list of those files:
  18.  
  19.         java.io.File
  20.     java.net.InetAddress
  21.     java.util.Hashtable
  22.     java.util.Date
  23.     sun.net.www.protocol.file.Handler
  24.  
  25. However, it will be easier to completely remove and replace RMI with
  26. upgraded versions if you install this release in another place.  The
  27. following directions assume that you will place it in an "rmi"
  28. directory in your home directory.  If you choose to install it as an
  29. overlay on top of the JDK, you can modify the directions accordingly.
  30. Instructions that can be skipped in an overlay installation are marked.
  31.  
  32. (1) Get the compressed tar file from the ftp site
  33.  
  34. (2) Extract the contents of the tar file into a directory
  35.  
  36.     Example:
  37.     % mkdir $HOME/rmi
  38.     % zcat rmi-prebeta1-solaris-sparc.tar.Z | (cd $HOME/rmi ; tar xvf -)
  39.  
  40. (3) Add the necessary zip files to your CLASSPATH and LD_LIBRARY_PATH
  41.     environment variables (LD_LIBRARY_PATH can be skipped in overlay)
  42.  
  43.     Example: (csh)
  44.     % setenv CLASSPATH $HOME/rmi/lib/rmi.zip:$CLASSPATH
  45.     % setenv LD_LIBRARY_PATH $HOME/rmi/lib/sparc:$LD_LIBRARY_PATH
  46.  
  47.     Example: (ksh)
  48.     % export CLASSPATH=$HOME/rmi/lib/rmi.zip:$CLASSPATH
  49.     % export LD_LIBRARY_PATH=$HOME/rmi/lib/sparc:$LD_LIBRARY_PATH
  50.  
  51.     (If you don't already have CLASSPATH (or LD_LIBRARY_PATH) set in
  52.     your environment, omit the :$CLASSPATH (or :$LD_LIBRARY_PATH) from
  53.     the lines above.)
  54.  
  55. (4) Set the RMIHOME environment variable (can be skipped in overlay)
  56.  
  57.     Example: (csh)
  58.     % setenv RMIHOME $HOME/rmi
  59.  
  60.     Example: (ksh)
  61.     % export RMIHOME=$HOME/rmi
  62.  
  63. (5) Set your path to include the bin directory so you can run the
  64.     stub/skeleton generation utility rmic (can be skipped in overlay)
  65.  
  66.     Example: (csh)
  67.     % set path = ($path $HOME/rmi/bin)
  68.  
  69.     Example: (ksh)
  70.     % PATH=$PATH:$HOME/rmi/bin
  71.  
  72. To get started, try running our examples.  For instructions see:
  73.  
  74.    rmi/examples/hello/README.txt
  75.    rmi/examples/stock/README.txt
  76.    
  77.  
  78. Applets in a Browser
  79. --------------------
  80.  
  81. The only browser that can run RMI applets with this release is the
  82. HotJava browser that is available from our site.  When you install
  83. HotJava, you must be sure that your binary search path ($PATH for sh
  84. and ksh, $path for csh) has the bin directory for the JDK *before* the
  85. bin directory for HotJava, or the RMI utilities will fail.
  86.  
  87. Support
  88. -------
  89.  
  90. Users of both RMI and object serialization can discuss issues and tips
  91. with other users via the mailing list rmi-users@java.sun.com.  You can
  92. subscribe by sending an email message containing the line
  93.  
  94.     subscribe rmi-users 
  95.  
  96. to listserv@java.sun.com, and unsubscribe by sending a message
  97. containing the line
  98.  
  99.     unsubscribe rmi-users
  100.  
  101. Support questions can be sent to rmi-support@java.sun.com.
  102.